Delete Tool Action

Used to delete a specific action from a tool. This permanently removes the action and its configuration from the tool.

API Endpoint

Property	Value
Request Method	DELETE
Request URL	https://api.seliseblocks.com/tools/{tool_id}/action/{action_id}

Request

Request Example

curl -X DELETE 'https://api.seliseblocks.com/tools/{tool_id}/action/{action_id}?project_key=YOUR_PROJECT_KEY' \
  -H 'accept: application/json'

Path Parameters

Field	Type	Required	Description
tool_id	string	Yes	The unique identifier of the tool.
action_id	string	Yes	The unique identifier of the action to delete.

Query Parameters

Field	Type	Required	Description
project_key	string	No	The project key for your project.

Request Headers

Field	Type	Required	Description
accept	string	Yes	Accepted response format. Use application/json

warning

Action Deletion Warning

• This operation permanently deletes the action and cannot be undone
• All action configuration including parameters and settings will be removed
• AI agents using this specific action will no longer be able to execute it
• Any workflows or automations relying on this action may fail
• Action execution history is retained for audit purposes

tip

Before deleting an action:

• Verify which AI agents are using this action
• Check for dependencies in workflows or automations
• Export or backup action configuration if needed
• Consider disabling the action instead of deleting it
• Notify team members who may be using the action
• Update documentation to reflect the removal

After successful deletion:

• Remove references to the action from AI agent prompts
• Update any workflows that depend on this action
• Test affected agents to ensure they work without the action
• Document the deletion for audit purposes

Response

Success Response (200 OK)

Returns an object containing the deletion status.

{
  "is_success": true,
  "item_id": "action_123",
  "detail": "Action deleted successfully from tool",
  "error": {}
}

Response Fields

Field	Type	Description
is_success	boolean	Indicates whether the deletion was successful.
item_id	string	The identifier of the deleted action.
detail	string	Success or failure message with additional context.
error	object	Error details if the operation failed (empty if successful).

Error Response (422 Unprocessable Entity)

Returns validation error details when the request parameters are invalid.

{
  "detail": [
    {
      "loc": [
        "path",
        "action_id"
      ],
      "msg": "action not found in tool",
      "type": "value_error.notfound"
    }
  ]
}

Error Response Fields

Field	Type	Description
detail	array	Array of validation error objects.
loc	array	Location of the error in the request (e.g., path, query).
msg	string	Human-readable error message.
type	string	Error type identifier.

Common Error Scenarios

Error Type	Description	Resolution
Action Not Found	Action ID doesn't exist in the tool	Verify the action_id is correct and belongs to the tool
Tool Not Found	Tool ID doesn't exist	Verify the tool_id is correct
Permission Denied	User lacks permission to delete actions	Check user permissions in project settings
Action In Use	Action is currently being executed	Wait for active executions to complete
Last Action	Cannot delete the only action in a tool	Add another action before deleting this one

Error Codes

Status Code	Description	Response Type
200	Successful Response	Success
400	Bad Request - Invalid request	Bad Request
403	Forbidden - Insufficient permissions	Forbidden
404	Not Found - Tool or action does not exist	Not Found
409	Conflict - Action is in use or is the last action	Conflict
422	Validation Error - Invalid request parameters	Unprocessable Entity